home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / zlascl.z / zlascl
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZLLLLAAAASSSSCCCCLLLL((((3333SSSS))))                                                          ZZZZLLLLAAAASSSSCCCCLLLL((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZLASCL - multiplie the M by N complex matrix A by the real scalar
  10.      CTO/CFROM
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE ZLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )
  14.  
  15.          CHARACTER      TYPE
  16.  
  17.          INTEGER        INFO, KL, KU, LDA, M, N
  18.  
  19.          DOUBLE         PRECISION CFROM, CTO
  20.  
  21.          COMPLEX*16     A( LDA, * )
  22.  
  23. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  24.      These routines are part of the SCSL Scientific Library and can be loaded
  25.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  26.      directs the linker to use the multi-processor version of the library.
  27.  
  28.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  29.      4 bytes (32 bits). Another version of SCSL is available in which integers
  30.      are 8 bytes (64 bits).  This version allows the user access to larger
  31.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  32.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  33.      only one of the two versions; 4-byte integer and 8-byte integer library
  34.      calls cannot be mixed.
  35.  
  36. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  37.      ZLASCL multiplies the M by N complex matrix A by the real scalar
  38.      CTO/CFROM. This is done without over/underflow as long as the final
  39.      result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
  40.      may be full, upper triangular, lower triangular, upper Hessenberg, or
  41.      banded.
  42.  
  43.  
  44. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  45.      TYPE    (input) CHARACTER*1
  46.              TYPE indices the storage type of the input matrix.  = 'G':  A is
  47.              a full matrix.
  48.              = 'L':  A is a lower triangular matrix.
  49.              = 'U':  A is an upper triangular matrix.
  50.              = 'H':  A is an upper Hessenberg matrix.
  51.              = 'B':  A is a symmetric band matrix with lower bandwidth KL and
  52.              upper bandwidth KU and with the only the lower half stored.  =
  53.              'Q':  A is a symmetric band matrix with lower bandwidth KL and
  54.              upper bandwidth KU and with the only the upper half stored.  =
  55.              'Z':  A is a band matrix with lower bandwidth KL and upper
  56.              bandwidth KU.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZLLLLAAAASSSSCCCCLLLL((((3333SSSS))))                                                          ZZZZLLLLAAAASSSSCCCCLLLL((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      KL      (input) INTEGER
  75.              The lower bandwidth of A.  Referenced only if TYPE = 'B',
  76.  
  77.      KU      (input) INTEGER
  78.              The upper bandwidth of A.  Referenced only if TYPE = 'B',
  79.  
  80.      CFROM   (input) DOUBLE PRECISION
  81.              CTO     (input) DOUBLE PRECISION The matrix A is multiplied by
  82.              CTO/CFROM. A(I,J) is computed without over/underflow if the final
  83.              result CTO*A(I,J)/CFROM can be represented without
  84.              over/underflow.  CFROM must be nonzero.
  85.  
  86.      M       (input) INTEGER
  87.              The number of rows of the matrix A.  M >= 0.
  88.  
  89.      N       (input) INTEGER
  90.              The number of columns of the matrix A.  N >= 0.
  91.  
  92.      A       (input/output) COMPLEX*16 array, dimension (LDA,M)
  93.              The matrix to be multiplied by CTO/CFROM.  See TYPE for the
  94.              storage type.
  95.  
  96.      LDA     (input) INTEGER
  97.              The leading dimension of the array A.  LDA >= max(1,M).
  98.  
  99.      INFO    (output) INTEGER
  100.              0  - successful exit <0 - if INFO = -i, the i-th argument had an
  101.              illegal value.
  102.  
  103. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  104.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  105.  
  106.      This man page is available only online.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.